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ZDT 


The Micronics, Inc. Z-8D Disassembler (ZDT) is a flexible 
operating aid for use in documenting and debugging programs, 
as well as assisting in machine language programming. ZDT has 
25 separate commands, all consisting of one letter of the 
alphabet, end followed optionally with address and data, 
according to the format of each command. The Disassembler 
runs under any memory size and it and it automatically 
relocates itself to the upper end of memory, 190nh bytes 
below the base of the CP/M or eqivalent operating system. 


INITIALIZATION 


The only change needed is to set the number of 128 byte 
sectors per track for disk reads and writes (W and R 
commands). The standard version of ZDT is set for 26 sectors. 
If you are using it with a system with other than 26 sectors 
track, load ZDT.COM with the L command and program 074AH 
{494AH for versions loading at 4300H) to the correct value 
with the P command. Then return to the operating system ( B 
command), and SAVE 24 ZDT.COM, as follows: 


A>ZDT 

. *> ' 

ZDT Version 1.40 (C) Micronics, Inc. 1980 

M>L ZDT.COM 
M>P 074A 

074A lA 40 {Enter correct number of sectors in hex) 

074B BA *0 (Enter control -C) 

M>B 

A>SAVE 24 ZDT.COM 
A> 


All functions of ZDT will correctly operate except for R and 
W of more than the number of sector for one track until this 
change is made. (Please note however that these changes have 
already been implemented for the ZENITH-HEATH H-89, TRS-80 
Model 1, and Intertec SUPERBRAIN.) 


Z80 is a registered trademark of Zilog, Inc. of Cupertino, 
CP/M is a trademark of Digital Research of Pacific Grove, CA. 
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USING ZDT 

(??) a -fter the eyste. 

any character will e^ter a c^and status. Typing 

signifying a bad a^co^and or will result in M>?, 

being typed. CTRL-p is other than A through Z 

system for printer—on-off switr>i and passed to the operating 
display. Entering %tl.C 

operation and return ^ 0 ms the current 

the program will execute th#» typing a command, 

accept Iddress or da?a! ^f ^ ®nd 

separate entry, then executfnn 

entering the final data keys^^ohe immediately upon 

entry, a delete or rub will made on 

backspace the displayf readi^tn^^i^ \ character and 

entry of address and byie datf char^T ® entry. On 

A-F are edited out At aL characters other than 0-8 or 

» the command can b^ abLtS^bv^fS^® complete 

returning to thrS> orom^r ^ CTRL-C , 

as a disassembler listing or dumn^ tb^ display of data, such 
hitting the space bar ^.v display can halted by 

display, or CTRL-C iill terminate^itcontinue the 

compute^by''aiding oli^tlThl^Sl^asB^at^oIeh 


breakpoint routine 

uL^^'belSS)?^ ""^Usinq ^?his^^® Of commands G, U, v and X 
language program with^up to si?° halts^^^® machine 

points must be chosen to Lu at tL • ^T^e 

instruction. Use the S i 7 beginning of an 

and uae u to aet the Sr?! 

set at any one time »nA\T breakpoints may be 

set. The purpose of 'the routl^e*^^?^^*^ currently 

execution of a program in mim%t allow controled 

instruction or *^mSule by setti^i debugging each 

observing the register dntnn i^be breakpoint, and 

executed! When SI Hg?™!, SLn"o” “ »>«®’'POint ia 

memory may be examined with the D of 

the program continued with the° ®*®o“ffon of 

bpon encounteISnSe“^IShIoSl?!Sft-^^ 
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has been encountered , the G conuhand prints a messagej NO 
BREAKPOINT SET, CONTINUE (Y/N). Answer Y to continue. If G is 
accidently typed in other circumstances and a Y is given, the 
registers are loaded with whatever junk is in the usual 
register storage area and the system jumps to a random 
address. This is not going to give good results. 


DISASM.TST 


DISARM.TST is a file containing Z-fln instructions. Load with 
the L command (L DISASM.TST). With no address specified, the 
file will be loaded at 0100 ^ ( 4300 }^ for relocated versions), 
so disassemble this test program by : S Oinn 04Dfi. (S 4300 
46D6.). This is just a sample of code to show the format of 
the S symbolic dump. 


ZDT COMMANDS 


The following is a summary of commands in the ZDT debugger. 
Use the CP/M DDT manual supplemented by these notes 


A bbbb 

Enters an ASCII character into memory from the keyboard, 
beginning with address bbbb. Echos the entry to the keyboard. 
Delete is not supported in this mode, and will enter any 
keystroke into the next memory location and continue until 
terminated by fCTRL-Cl, then prints the next available 
address before returning to M>. 


B 

Warm Boot (returns to CP/M). B does not disturb the programs 
in the TPA (0100 to the bottom of CP/M 4300 for the relocated 
version) so that programs may be saved with the modifications 
made by the disassembler. Type SAVE (etc. see CP/M 
information for correct syntax). 
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C bbbb eeee nnnn 

Memory compare. CoPipares byte by byte a memory block starting 
at bbbb and ending at eeee-1 with the block starting at nnnn. 
Useful in verifying prom programming, or other data supposed 
to be the same. Prints address and data in first block then 
data in other block when compare fails, or nothing at all if 
compare succeeds. 


D bbbb eeee 

Dumps hex and ASCII value of memory between addresses bbbb 
and eeee. Does not include byte at eeee if another line would 
be generated. Fills all of last line, even if greater than 
eeee. 


E bbbb eeee rAsciI STRING*" , ' 

Search for ASCII string (limit 36 characters) printing 
occurrences of string from address bbbb to eeee, not 
including eeee. Requires carriage return at end of string 
entry. 


F bbbb eeee ThEX STRINGT 

Search for hex string (limit 16 bytes) printing addresses of 
all occurrences of the specified combination from address 
bbbb to and not including eeee. Requires carriage return to 
signify end of string of hex bytes. 


G 

% 

Go to next breakpoint. Loads registers as they were upon 
encountering the breakpoint, restores the instruction at the 
old breakpoint, and will continue execution to the next 
breakpoint. If G is used without a breakpoint, the message NO 
BREAKPOINTS SET,CONTINUE (y,N) will display. 
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H aaaa nnnn 

Hex add and subtract. Prints + and the sum, - and the 
difference in hex on the console. 


I nn 

Input. Prints the hex value at the input port nn. 


j nnnn 

Jump to and execute location nnnn. Puts the M> entry point on 
the stack, so the routine at nnnn can end in a return, if So 
desired. This is convenient when testing subroutines or 
modules of a larger program. 


K . 

Keyboard echo. Inputs from keyboard, and puts out to console. 
Memory not affected. 


L filename.ext nnnn 

Loads a disk file to location nnnn so it can be dissambled or 
dumped (default is to 0100 Hex, 4300 Hex for the relocated 
version). For instance, L BzDISASM.COM will load the 
disassembler for disassembly. B: is the' drive number, and 
Can be omitted for drive A. It is possible to load a file 
which is too big to fit under the disassembler, and will 
write over it, causing a halt to the proceedings. 


M bbbb eeee nnnn 

Move a block of data beginning at bbbb and ending at eeee -1 
to nnnn. Moves files up and down in memory, one byte or many. 
Does not get confused and write over itself. 
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N aaaa 

Fnters offset aaaa. Thi <5 aii/sue 

disassembling at an addKss ttan iSe tL 

subtractinq the offe^^i- e .11 t.nan the run address, and 

Symbolic Dump, etc. use the printed on Dump, 

determine the correct offset Pn+A^ necessary to 

return to reenter the defaui; value of OODonnoma?)''^'''''^^^ 


0 nn dd 

output. Puts byte dd out to port nn. 

P bbbb 

Program. Keyboard programming, input hex from keyboard anfl 

Q bbbb eeee 

Prints ASCII, of any, from memory location bbbb to eeee-l. 

R n 11 tt ss bbbb 

=?artinrat°lr«i%rSJd''s!\" bytes) 

eii uxiig ay rracK tt and sector ss, placino the fle-ha a-i- 

valnes'^for tl nn%f 4 ““; 

^a?5es win v«v 5" «i'bette formats. These 

values will vary depending on the size of your disk Pefei- 

your hardware manual for details. ^ 
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S bbbb eeee 

Symbolic dump. Prints addresses, the hex code located there, 
and the Zilog/Mostec mnemonic for the instruction represented 
from address bbbb to eeee -1. The last instruction will be 
printed entirely if the end address falls within a two-or 
more-byte opcode. 


T bbbb eeee 

Destructive memory test from location bbbb to eeee-1. If this 
core includes the stack (at OPOH) or the disassembler, 
results will not be as expected. Prints memory addresses, the 
byte which was written, and the byte fetched, when errors 
occur. 


U bbbb 

r 

Ret breakpoint at address bbbb. Up to six breakpoints may be 
set at one time. More than six will generate an error 
message. Breakpoint will be reset to the original byte when 
found and the G command used to continue execution. 


V 

Displays all currently set breakpoints. 


W n 11 tt ss bbbb 

Write on disk n the data at bbbb for a length of 11 starting 
at track tt, sector ss. Writes sequentially until the length 
(in pages) is written to disk. See above under R (read). 
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X ■' 

Registers display. Current contents of all the ZflO registers 
Y 

Not used. 


Z bbbb eeee dd 

Places in memory locations startinq with 
bbbb and ending with eeee -1 the byte dd. 




LIFEBOAT ASSOCIATES 
SOFTWARE PROBLEM REPORT 


Please use this form to report errors or problems in software 
supplied by Lifeboat Associates. This form is designed to act as 
a transmittal sheet, and problem details can be described on 
additional pages. 

Date; _ 

Software Product Name;_Version No. 


Disk Format:^_Serial Number; 

Computer Type; _ CPU Type; 

Operating System; Serial Number;^_ Version; 


Memory Size;__ Number of Disk Drives; 

Please describe the problem you have encountered. Include 
references to the manual if appropriate. Try to reduce the 
problem to a simple test case. Enclose any appropriate listings. 
If you have discovered a patch or interim solution please 
describe it. 

This form may also be used to suggest enhancements to our 
software products. 

Information on product changes and current version numbers are 
published in Lifelines , our software newsletter. 


PROBLEM DESCRIPTION; 


Name;_ 

Address; 
City;_ 


Phone; 


State; Zip; 


Return to; Lifeboat Associates 
1651 Third Avenue 
New York, New York 10028 


lspr-08/01/80 






